home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 003 / dbtools.arc / CPAINTIT.DOC < prev    next >
Encoding:
Text File  |  1986-09-24  |  2.5 KB  |  53 lines
  1.  
  2.              PAINTIT dBASE III(1) Screen Paint/Load Call Routine
  3.            ⌐ 1986, Kenneth E. Wilson, Digital Equipment Corporation
  4.  
  5. This program is provided to the DECdomain with the condition that it
  6. not be sold or included in any application which is sold.  This program
  7. is not warranted or guarranteed nor is it supported by its author.  Any
  8. problems found in this application should be logged in the dBASE notesfile.
  9.                     
  10. This routine when loaded will print the Rainbow video screen from a specified
  11. disk file.  If the file cannot be read an error message will appear on the
  12. screen and the routine will exit normally.  Nothing will be written to the
  13. screen unless the above error occurs. This routine is intended ONLY for 
  14. the following system configuration:  RAINBOW 100A/B, dBASE III V1.1 on
  15. MS-DOS(3) V2.11 or later.
  16.  
  17. To enable use of PAINTIT issue the following dBASE III command:
  18. .LOAD PAINTIT
  19.  
  20. The call is structured as follows:
  21.  
  22. CALL PAINTIT WITH 'filename'
  23.      ^             ^
  24.      |- Function   |- Standard valid MS-DOS filespec
  25.         name       
  26.  
  27. The file used in this call MUST have been saved by the call SAVEIT from this
  28. author or by the program DO-IT and SWITCH-IT/DESK(2).  PAINTIT remembers the
  29. width of the screen on its last call and expects the screen width to remain
  30. constant, i.e. if your first call is with a screen image file for a 132
  31. column screen and you change the screen width after the call to 80 column,
  32. and the next image file you call PAINTIT with is also for a 132 column
  33. screen then the video ram will be corrupted.  To prevent this from happening
  34. simply change the screen back to 132 before calling PAINTIT with the second
  35. file.  Note:  the reason for processing the screen width in this way is the
  36. extremely slow Rainbow screen width change function.  With PAINTIT
  37. remembering the last screen width subsiquent paints are MUCH faster.
  38.  
  39. One other note on PAINTIT is that the name of the last file painted is
  40. remembered for 'redisplaying'.  If the entire filespec on the second call is
  41. exactly the same as the prior call then no disk access will take place.  The
  42. copy of the file that is already in memory will be reused.
  43.  
  44. See the SAVEIT and PRINTIT routines also available from this author.
  45.  
  46. This routine may work on dBASE III V1.0, but specific loading and calling
  47. syntax is different and as I understand V1.0 only one routine can be loaded
  48. at any one time.
  49.  
  50. (1) dBASE III is a trademark of Ashton-Tate
  51. (2) SWITCH-IT/DESK is a trademark of VuSoft
  52. (3) MS is a trademark of MicroSoft
  53.